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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
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Foreword 

This Technical Specification (TS) has been produced by ETSI Project Smart Card Platform (SCP). 

The contents of the present document are subject to continuing work within EP SCP and may change following formal 
EP SCP approval. If EP SCP modifies the contents of the present document, it will then be republished by ETSI with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

early working draft; 

1 presented to EP SCP for information; 

2 presented to EP SCP for approval; 

3 or greater indicates EP SCP approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document defines additional featiu'es that shall be provided by the UICC to support EAP authentication 
capabilities. 

The goal of these new features is to adapt the UICC to provide support of different EAP methods, ensuring 
interoperability between the UICC and any terminal independently of their respective manufacturers. 

The present document defines: 

• The architectural framework. 

• The additional commands required. 
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3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following definitions apply: 

authenticator: end of the EAP link initiating EAP authentication 

peer or supplicant: end of the EAP Link that responds to the authenticator 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

DF Dedicated File 

EAP Extensible Authentication Protocol 

EF Elementary File 

L2TP Layer two Tunnelling Protocol 

LAN Local Area Network 

NAI Network Access Identifier 

PPP Point-to-Point Protocol 

TLS Transport Layer Security 

WEP Wired Equivalent Privacy 



Introduction 



The Extensible Authentication Protocol is a general authentication framework, which supports multiple authentication 
methods. EAP typically may run directly over data link layers such as PPP (see RFC 1661 [6]) or 
IEEE Std 802.1X-2001 [7] and IEEE Std 802.11-1999 [8]. 

As described in RFC 3748 [1], EAP implementations consist of three main components: 

• A lower layer that is responsible for transmitting and receiving EAP frames between the peer and the 
authenticator. EAP has been run over a variety of lower layers (including PPP, IEEE 802 LANs, IEEE 802.1 1 
WLANs, and L2TP (see RFC 2661 [5])). 

• An EAP layer that receives and transmits EAP packets via the lower layer, implements duplicate detection 
and retransmission, and delivers and receives EAP messages to and from EAP methods. 

• EAP methods that implement the authentication algorithms and receive/transmit EAP messages via the EAP 
layer. 

The UICC offers suitable possibilities for the implementation of some of these EAP methods in the peer side, since it 
provides the required protection of credentials and authentication algorithms. This is even more important when the 
following conditions apply: 

• The authentication methods require the usage of credentials that are stored in the UICC. 

• For security reasons, these credentials shall not be revealed in clear in an unprotected peer environment 
(e.g. a laptop or mobile terminal). 

The present document defines the principles that shall be implemented in the UICC in order to enable that UICC 
applications may support one or more of these EAP methods. 
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5 Architecture 

5.1 Architectural Principles 

The following architectural principles are applied: 

• The authenticator is able to perform an EAP authentication process (using an specific EAP method) with a 
UICC application implementing this method. That means that the authentication is performed end-to-end 
between the authenticator and the UICC application. 

• The peer is composed of several components: 

The UICC EAP Framework provides information to the terminal about the existing UICC applications 
that provide UICC EAP clients. 

A UICC application provides one or more UICC EAP clients. 

A UICC EAP client implements one specific EAP method. 
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Figure 5.1 : EAP architecture when supplicant is split between a UICC and a terminal 



5.2 EAP clients discovery 



When a UICC application implements one or more EAP clients, its corresponding record in EF^jj^ shall contain the 
following EAP related Data Objects: 

• Application EAP support types list: defining the EAP methods supported by the corresponding UICC 
application. 

• Application EAP Dedicated File list: defining a list of Dedicated Files, each of them associated to one 
supported EAP method. Likewise, each EAP method is associated to one DF. Each of this DF are hereafter 



referred as DFi 



EAP- 



Application EAP Label: Defining a user readable label defining the EAP clients. 
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Table 5.1 : Coding of EAP related DOs 



Length 


Description 


Status 




Discretionary template tag = "73" 


M 




Length of the discretionary template 


M 




EAP Application service specific data content tag (="A0") 


M 




EAP Application service specific data content length 


M 




Application EAP supported types list tag = "80" 


M 




Length of the Application EAP supported types list 


M 


A 


Application EAP supported types list 


M 




Application EAP Dedicated file list tag = "81" 


M 




Length of Application EAP Dedicated file list 


M 


B 


Application EAP Dedicated File list 


M 




Application EAP Label tag = "82" 


M 




Length of the Application EAP Label 


M 


C 


Application EAP Label 


M 



Coding: 

• Application EAP supported types list: 

Contain a list of supported EAP type (as defined in RFC 3748 [1]) each of them coded in one byte except for expanded 
types that are coded on 8 bytes. 

EXAMPLE 1: An UICC application supporting EAP-MD5 (see RFC 3748 [1]) and EAP-TLS (see RFC 2716 [3]) 
provides the following "Application EAP supported types list": 

"040D"corresponding to EAP-MD5 (Type=4) and EAP-TLS (Type=13). 

• Application EAP Dedicated Files list: 

Contain a list of file identifiers of each DFg^^ associated to a particular supported EAP type. Each of them coded in 

two bytes. 

EXAMPLE 2: Using the previous example, A DF "6D34" for EAP-MD5 and a DF "6D35" for EAP-TLS will 
result in the following EAP Dedicated Files list: 

"6D346D35". 

• Application EAP label: 

The application label is a DO that contains a string of bytes provided by the application provider to be shown to the user 
for information. 

5.3 EAP-capable-application selection 

The terminal shall use the information in EFj-,j[^ file if available to present the list of EAP-capable applications to the 
user or to any application that may request an EAP authentication. 

The terminal shall then select the corresponding EAP-capable-application to start an EAP authentication. Once selected, 
all EAP-Client state machines of the application are reset. 

5.4 Key derivation 

It is possible for many EAP methods to derive key material after successful authentications. These keys may be used for 
subsequent processes (e.g. for WEP encryption in IEEE Sdt 802.11-1999 [8]). 

Keys derived from an authentication shall be retrieved by the terminal by inspecting the mandatory file EFg^pj^ys- 



£75/ 



Release 6 9 ETSI TS 1 02 31 V6.2.0 (2005-09) 

5.5 Authentication Status 

The terminal may retrieve the authentication status of the EAP chent in the selected UICC application by inspecting the 
mandatory file EFg^psTATUS- 



6 EAP related Commands 

The following clauses specify the additional commands needed to implement the EAP framework in the UICC. 

6.1 EAP Authenticate 
6.1 .1 Command description 

The function is used to transfer the EAP packets from the terminal to the selected UICC EAP client (i.e. EAP client in 
the selected UICC application that corresponds to the given EAP type). 

The UICC EAP client shall provide a response EAP packet (as defined in RFC 3748 [1]) or a warning status word 
according to the authentication method being used. 

The UICC EAP client shall maintain the state machine of the authentication process as described for the particular EAP 
method used. 

The function is related to a particular UICC application supporting EAP and shall not be executable unless this 
application has been selected and activated, and the current directory is a DFg^y, corresponding to a specific EAP 

method. The correspondence between EAP type and the current DFg^^ is defined in EF^jj^. 

Each UICC application implementing a UICC EAP client may require different security conditions to execute this 
command (e.g. user PIN verification). 

The format of the EAP packet is defined by the application implementing the EAP client and shall respect the 
conventions corresponding for the EAP method. 

The following EAP packets are allowed input packets for this command: EAP packets with code field equal to 

1 "Request", 3 "Success" or 4 "Failure" and EAP packets with code equal to 2 "Response" for EAP type 1 "Identity" 

(Code and type values as defined in RFC 3748 [1]). 

NOTE: EAP Response Identity packet may be delivered to the UICC application when the identity is managed 
outside the UICC application and the method itself needs to have access to the chosen identity. 

The command and response data may contain specific EAP method related data as an additional input/output parameter 
(e.g. gmt_unix_time for EAP-TLS implementations as defined in RFC 2716 [3]). 

Input: 

• EAP Packet; 

• EAP method related data. 
Output: 

• Either none (i.e. if authentication successful: EAP success packet received). 
Or: 

• EAP Response Packet; 

• EAP method related data. 
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6.1.1.1 



Command parameters and data 



Code 


Value 


CLA 


As specified in ETSI TS 102 221 [2] 


INS 


"88" 


P1 


"00" 


P2 


See table 6.1 


Lc 


Length of subsequent EAP command data 


Data 


See below 


Le 


Length of the response data 



Table 6.1 : Coding of P2 



b8 


b7 


b6 


b5 


b4 


b3 


b2 


b1 


Meaning 


1 


- 


- 


- 


- 


- 


- 


- 


Specific reference data (DF ^^p application 
dependent KEY) 


- 


X 


X 


- 


- 


- 


- 


- 


"00" (other values are RFU) 


- 


- 


- 


X 


X 


X 


X 


X 


Reference data number ("01 " to "1 F") 


























See TS 102 221 [2] 


NOTE: The reference data number assignment rule shall be defined in the application 
specification referencing the present document. 



The reference data number assignment rule shall be defined in the application specification referencing the present 
document. In case the UlCC based application specification does not define a Reference Data Number for the EAP 
AUTHENTICATE command, then P2 shall be set to "00". 

Command data: 



Byte(s) 


Description 


Length 


1 -Lc 


EAP command data (see table 6.2) 


Lc 



Table 6.2: Coding of EAP command data 



Byte(s) 


Description 


Status 


Length 


1-J 


EAP packet (coded as defined for the method 
of EAP used as defined in RFC 3748 [1]) 


M 


J bytes 


J+1-J+K+1 


EAP method related data (must be specified by 
each application specific document defining a 
particular EAP method implementation) 





K bytes 


NOTE: The length of an EAP packet is contained within the packet and can therefore be 
retrieved from it. 



The length of an EAP packet is contained within the packet and can therefore be retrieved from it. 
Response data: 



Byte(s) 


Description 


Length 


1 -Le 


EAP Packet Response Data (see table 6.3) 


Le 



Table 6.3: Coding of EAP Response data 



Byte(s) 


Description 


Status 


Length 


1-L 


EAP packet 


M 


L bytes 


L+1-L+N+1 


EAP method related data (must be specified by 
each application specific document defining a 
particular EAP method implementation) 





N bytes 


NOTE: The length of an EAP packet is contained within the packet and can therefore be 
retrieved from it. 
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The length of an EAP packet is contained within the packet and can therefore be retrieved from it. 

6.2 Specific status conditions returned 

This clause specifies the coding of the specific status words SWl and SW2. 

6.2.1 Status words 

Table 6.4 shows the meaning of possible status conditions returned. 

Table 6.4: Status byte coding - warnings 



SWl 


SW2 


Description 


"62" 


"00" 


- No information given, state of non volatile memory unchanged (EAP 
Packet silently ignored) 


Table 6.5: Status byte coding - application errors 


SWl 


SW2 


Description 


"98" 


"62" 


- Authentication error (EAP Failure Packet received) 



7 



EAP Files 



This clause describes the files present in an application supporting an EAP type. The following files are situated under 
the corresponding DF£^^ of a particular UICC application. 



7.1 



EF 



EAPKEYS 



(EAP derived keys) 



This EF contains the key material derived after a successful EAP authentication. 

Structure of EF^^^pkeys 



Identifier: "4F01" 


Structure: transparent 


Conditional 
(see note) 


File size: n | Update activity: high 


Access Conditions: 
READ PIN 
UPDATE ADM/NEVER 
DEACTIVATE ADM 
ACTIVATE ADM 


Bytes 


Description 


M/0 


Length 


1 


1 St Key Tag 





1 bytes 


2 


ist Key Length 





1 bytes 


3toL1+2 


ist Key Value 





L1 bytes 










2(k-1) + L1+ + 
L(k-1) + 1 


KSt Key Tag 





1 bytes 


2(k-1) + L1+ + 
L(k-1)+ 2 


KSt Key Length 





1 bytes 


(2(k-1) + L1+ + 
L(k-1)+ 3)to(L1 
+ ... + Lk + 2k) 


Kst Key Value 





LK bytes 


NOTE: The presence of this file depends on the supported EAP method. 



NOTE: The presence of this file depends on the supported EAP method. 
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Key Tag 

Contents: 

■ Identifier of the derived key. 
Coding: 

■ The assigned Key tag values are given in the following table. 



Derived key description 


Key tag value 


Reference 


IVIaster Session Key (IVISK) 


"80" 


RFC 3748 [1] 


Extended IVIaster Session Key (EIVISK) 


"81" 


RFC 3748 [1] 



Key Length 
Contents: 

■ Length of the derived key. 
Key Value 

Contents: 

■ Derived key. 

EFeapstatus (EAR Authentication STATUS) 

This EF contains the authentication status corresponding to the EAP client supported by the application. 

Structure of EFeapstatus 



7.2 



Identifier: "4F02" Structure: transparent IVIandatory 


File size: 1 Update activity: high 


Access Conditions: 

READ PIN 

UPDATE ADM/NEVER 

DEACTIVATE ADM 

ACTIVATE ADM 


Bytes 


Description 


M/0 


Length 


1 


Authentication Status 


M 


1 bytes 



Authentication Status 
Contents: 

■ Status of the corresponding EAP authentication. 
Coding: 

■ Authentication Status coded in one byte as below. 



Value 


Meaning 


"00" 


No authentication started 


"01" 


Authenticating 


"02" 


Authenticated 


"03" 


Held (Authentication failure) 
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7.3 EFpuid (Permanent User Identity) 



This EF contains the permanent user identity. Permanent User identity may be used as the username part of the Network 
Access Identifier (see RFC 2486 [4]). 

This File is not mandatory if the Permanent user identity is derived by other means. 

Structure of EFpuij 



Identifier: "4F03" Structure: transparent Optional 


File size: n (where n >10 bytes) Update activity: low 


Access Conditions: 
READ PIN 
UPDATE ADM 
DEACTIVATE ADM 
ACTIVATE ADM 


Bytes 


Description 


MO 


Length 


1 ton 


Permanent user identity 


M 


n bytes 



Permanent user identity 
Contents: 

■ user identity to be used as the username part of the NAI. 
Coding: 

■ Binary. Unused bytes shall be set to "FF" and shall not be considered as a part of the value. 



7.4 EFp3 (Pseudonym) 



This EF contains a temporary user identifier (pseudonym) for subscriber identification. Pseudonyms may be provided as 
part of a previous authentication sequence. This may be used as the username part of the Network Access Identifier 
(see RFC 2486 [4]). 

This file is not mandatory if pseudonyms are not managed by the application or they are derived by other means. 

Structure of EFpg 



Identifier: "4F04" 




Structure: transparent Optional 


File size: 


n 


Update activity: high 


Access Conditions: 

READ 

UPDATE 

DEACTIVATE 

ACTIVATE 


PIN 
PIN 

ADM 
ADM 




Bytes 


Description 


M/0 


Length 


1 ton 


Pseudonym 


M 


n bytes 



• Pseudonym 

Contents: 

■ Pseudonym to be used as the username part of the NAI. 
Coding: 

■ Binary. Unused bytes shall be set to "FF" and shall not be considered as a part of the value. 
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